home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 2: Applications / Linux Cubed Series 2 - Applications.iso / editors / emacs / xemacs / xemacs-1.004 / xemacs-1 / xemacs-19.13 / src / redisplay.h < prev    next >
Encoding:
C/C++ Source or Header  |  1995-08-18  |  15.2 KB  |  522 lines
  1. /* Redisplay data structures.
  2.    Copyright (C) 1994, 1995 Board of Trustees, University of Illinois
  3.  
  4. This file is part of XEmacs.
  5.  
  6. XEmacs is free software; you can redistribute it and/or modify it
  7. under the terms of the GNU General Public License as published by the
  8. Free Software Foundation; either version 2, or (at your option) any
  9. later version.
  10.  
  11. XEmacs is distributed in the hope that it will be useful, but WITHOUT
  12. ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13. FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14. for more details.
  15.  
  16. You should have received a copy of the GNU General Public License
  17. along with XEmacs; see the file COPYING.  If not, write to the Free
  18. Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.  */
  19.  
  20. #ifndef _XEMACS_REDISPLAY_H_
  21. #define _XEMACS_REDISPLAY_H_
  22.  
  23. /* Redisplay DASSERT types */
  24. #define DB_DISP_POS            1
  25. #define DB_DISP_TEXT_LAYOUT        2
  26. #define DB_DISP_REDISPLAY        4
  27.  
  28. /* These are the possible return values from pixel_to_glyph_translation. */
  29. #define OVER_MODELINE        0
  30. #define OVER_TEXT        1
  31. #define OVER_OUTSIDE        2
  32. #define OVER_NOTHING        3
  33. #define OVER_BORDER        4
  34. #define OVER_TOOLBAR        5
  35.  
  36. #define NO_BLOCK    -1
  37.  
  38. struct window_mirror;
  39.  
  40. /* Imagine that the text in the buffer is displayed on a piece of paper
  41.    the width of the frame and very very tall.  The line start cache is
  42.    an array of struct line_start_cache's, describing the start and
  43.    end buffer positions for a contiguous set of lines on that piece
  44.    of paper. */
  45.  
  46. struct line_start_cache
  47. {
  48.   Bufpos start, end;
  49.   int height;
  50. };
  51.  
  52. typedef struct line_start_cache_dynarr_type
  53. {
  54.   Dynarr_declare (struct line_start_cache);
  55. } line_start_cache_dynarr;
  56.  
  57. enum rune_type
  58. {
  59.   BLANK,
  60.   CHAR,
  61.   DGLYPH,
  62.   HLINE,
  63.   VLINE            /* #### not implemented -- future possibility */
  64. };
  65.  
  66. enum cursor_type
  67. {
  68.   CURSOR_ON,
  69.   CURSOR_OFF,
  70.   NO_CURSOR,
  71.   NEXT_CURSOR,
  72.   IGNORE_CURSOR
  73. };
  74.  
  75. #define DEFAULT_INDEX    (face_index) 0
  76. #define MODELINE_INDEX    (face_index) 1
  77.  
  78. /* A rune is a single display element, such as a printable character
  79.    or pixmap.  Any single character in a buffer has one or more runes
  80.    (or zero, if the character is invisible) corresponding to it. */
  81.    
  82. struct rune
  83. {
  84.   face_index findex;        /* face rune is displayed with */
  85.   Lisp_Object extent;        /* extent rune is attached to, if any */
  86.  
  87.   short xpos;            /* horizontal starting position in pixels */
  88.   short width;            /* pixel width of rune */
  89.  
  90.   enum cursor_type cursor_type;    /* is this rune covered by the cursor? */
  91.  
  92.   Bufpos bufpos;        /* buffer position this rune is displaying */
  93.   Bufpos endpos;        /* if set this rune covers a range of pos */
  94.   enum rune_type type;        /* type of rune object */
  95.   union
  96.   {
  97.     /* DGLYPH */
  98.     struct
  99.     {
  100.       Lisp_Object glyph;
  101.       int xoffset;
  102.     } dglyph;
  103.  
  104.     /* CHAR */
  105.     Emchar ch;
  106.  
  107.     /* HLINE */
  108.     struct
  109.     {
  110.       int thickness;        /* how thick to make hline */
  111.       int yoffset;        /* how far down from top of line to put top */
  112.     } hline;
  113.   } object;            /* actual rune object */
  114. };
  115.  
  116. typedef struct rune_dynarr_type
  117. {
  118.   Dynarr_declare (struct rune);
  119. } rune_dynarr;
  120.  
  121. /* These must have distinct values.  Note that the ordering actually
  122.    represents priority levels.  TEXT has the lowest priority level. */
  123. enum display_type
  124. {
  125.   TEXT,
  126.   LEFT_OUTSIDE_MARGIN,
  127.   LEFT_INSIDE_MARGIN,
  128.   RIGHT_INSIDE_MARGIN,
  129.   RIGHT_OUTSIDE_MARGIN,
  130.   OVERWRITE
  131. };
  132.  
  133. struct display_block
  134. {
  135.   enum display_type type;    /* type of display block */
  136.  
  137.   int start_pos;        /* starting pixel position of block */
  138.   int end_pos;            /* ending pixel position of block */
  139.  
  140.   rune_dynarr *runes;        /* Dynamic array of runes */
  141. };
  142.  
  143. typedef struct display_block_dynarr_type
  144. {
  145.   Dynarr_declare (struct display_block);
  146. } display_block_dynarr;
  147.  
  148. typedef struct layout_bounds_type
  149. {
  150.   int left_out;
  151.   int left_in;
  152.   int left_white;
  153.   int right_white;
  154.   int right_in;
  155.   int right_out;
  156. } layout_bounds;
  157.  
  158. struct glyph_block
  159. {
  160.   Lisp_Object glyph;
  161.   Lisp_Object extent;
  162.   /* The rest are only used by margin routines. */
  163.   face_index findex;
  164.   int active;
  165.   int width;
  166. };
  167.  
  168. typedef struct glyph_block_dynarr_type
  169. {
  170.   Dynarr_declare (struct glyph_block);
  171. } glyph_block_dynarr;
  172.  
  173. struct display_line
  174. {
  175.   short ypos;                /* vertical position in pixels */
  176.   unsigned short ascent, descent;    /* maximum values for this line */
  177.   unsigned short clip;            /* amount of bottom of line to clip */
  178.   Bufpos bufpos;            /* first buffer position on line */
  179.   Bufpos end_bufpos;            /* last buffer position on line */
  180.   Charcount offset;            /* adjustment to bufpos vals */
  181.   Charcount num_chars;            /* # of chars on line
  182.                        including expansion of tabs
  183.                        and control chars */
  184.   int cursor_elt;            /* rune block of TEXT display
  185.                        block cursor is at or -1 */
  186.   char used_prop_data;            /* can't incrementally updated if line
  187.                        used propogation data */
  188.  
  189.   layout_bounds bounds;            /* line boundary positions */
  190.  
  191.   char modeline;            /* t if this line is a modeline */
  192.  
  193.   /* Dynamic array of display blocks */
  194.   display_block_dynarr *display_blocks;
  195.  
  196.   /* Dynamic arrays of left and right glyph blocks */
  197.   glyph_block_dynarr *left_glyphs;
  198.   glyph_block_dynarr *right_glyphs;
  199. };
  200.  
  201. typedef struct display_line_dynarr_type
  202. {
  203.   Dynarr_declare (struct display_line);
  204. } display_line_dynarr;
  205.  
  206. enum prop_type
  207. {
  208.   PROP_STRING,
  209.   PROP_CHAR,
  210.   PROP_MINIBUF_PROMPT,
  211.   PROP_BLANK
  212. };
  213.  
  214. /* Data that should be propagated to the next line.  Either a single
  215.    Emchar or a string of Bufbyte's. */
  216.  
  217. struct prop_block
  218. {
  219.   enum prop_type type;
  220.  
  221.   union data
  222.   {
  223.     struct
  224.     {
  225.       Bufbyte *str;
  226.       Bytecount len;
  227.       Bytecount pos;
  228.     } p_string;
  229.  
  230.     struct
  231.     {
  232.       Emchar ch;
  233.       Bufpos cursor_bufpos;
  234.       enum cursor_type cursor_type;
  235.     } p_char;
  236.  
  237.     struct
  238.     {
  239.       int width;
  240.       face_index findex;
  241.     } p_blank;
  242.   } data;
  243. };
  244.  
  245. typedef struct prop_block_dynarr_type
  246. {
  247.   Dynarr_declare (struct prop_block);
  248. } prop_block_dynarr;
  249.  
  250. /* It could be argued that the following two structs belong in
  251.    extents.h, but they're only used by redisplay and it simplifies
  252.    the header files to put them here. */
  253.  
  254. typedef struct extent_dynarr_type
  255. {
  256.   Dynarr_declare (struct extent *);
  257. } extent_dynarr;
  258.  
  259. /* NOTE NOTE NOTE: Currently the positions in an extent fragment
  260.    structure are Bytind's, not Bufpos's.  This could change. */
  261.  
  262. struct extent_fragment
  263. {
  264.   struct buffer *buf;
  265.   struct frame *frm;
  266.   Bytind pos, end;
  267.   extent_dynarr *extents;
  268.   glyph_block_dynarr *begin_glyphs, *end_glyphs;
  269.   int invisible;
  270. };
  271.  
  272. struct font_metric_info
  273. {
  274.   int width;
  275.   int height;            /* always ascent + descent; for convenience */
  276.   int ascent;
  277.   int descent;
  278.  
  279.   char proportional;
  280. };
  281.  
  282. typedef struct position_redisplay_data_type
  283. {
  284.   /* This information is normally filled in by the create_*_block
  285.      routines and is used by the add_*_rune routines. */
  286.   Lisp_Object window;
  287.   struct device *d;
  288.   struct display_block *db;
  289.   struct display_line *dl;
  290.   Emchar ch;
  291.   Bufpos bufpos;
  292.   Bufpos endpos;
  293.   int pixpos;
  294.   int max_pixpos;
  295.   int width;
  296.   Bufpos cursor_bufpos;    /* This stores the buffer position of the cursor. */
  297.   enum cursor_type cursor_type;
  298.   int cursor_x;        /* rune block cursor is at */
  299.   int start_col;
  300.   int start_col_enabled;
  301.  
  302.   /* Information about the face the text should be displayed in and
  303.      any begin-glyphs and end-glyphs. */
  304.   struct extent_fragment *ef;
  305.   face_index findex;
  306.   struct font_metric_info fm;
  307.  
  308.   /* The height of a pixmap may either be predetermined if the user
  309.      has set a baseline value, or it may be depedent on whatever the
  310.      line ascent and descent values end up being based just on font
  311.      information.  In the first case we can immediately update the
  312.      values, thus there inclusion here.  In the last case we cannot
  313.      determine the actual contribution to the line height until we
  314.      have finished laying out all text on the line.  Thus we propagate
  315.      the max height of such pixmaps and do a final calculation after
  316.      all text has been added to the line. */
  317.   int new_ascent;
  318.   int new_descent;
  319.   int max_pixmap_height;
  320.  
  321. } pos_data;
  322.  
  323. /* If non-zero, a window-system was specified on the command line.
  324.    Defined in emacs.c. */
  325. extern int display_arg;
  326.  
  327. /* Type of display specified.  Defined in emacs.c. */
  328. extern char *display_use;
  329.  
  330. extern emchar_dynarr *mode_string_buffer;
  331. extern bufbyte_dynarr *mode_spec;
  332. extern Lisp_Object Vglobal_mode_string;
  333.  
  334. extern void redisplay (void);
  335. extern struct display_block *get_display_block_from_line (struct display_line *dl, enum display_type type);
  336. extern layout_bounds calculate_display_line_boundaries (struct window *w,
  337.                             int modeline);
  338. extern Bufpos point_at_center (struct window *w, int type, int regen,
  339.                    Bufpos start, Bufpos point);
  340. extern int line_at_center (struct window *w, int type);
  341. extern int window_half_pixpos (struct window *w);
  342. extern void redisplay_echo_area (void);
  343. extern int generate_modeline_string (struct window *w, int pos, int min_pos,
  344.                      int max_pos, Lisp_Object elt, int depth,
  345.                      int max_pixsize, face_index findex,
  346.                      int type);
  347. extern void free_display_structs (struct window_mirror *mir);
  348. extern int pixel_to_glyph_translation (struct frame *f, int x_coord,
  349.                        int y_coord, int *col, int *row,
  350.                        int *obj_x, int *obj_y,
  351.                        struct window **w, Bufpos *bufpos,
  352.                        Bufpos *closest, Lisp_Object *class);
  353. extern void glyph_to_pixel_translation (struct window *w, int char_x,
  354.                     int char_y, int *pix_x, int *pix_y);
  355. extern void mark_redisplay (void (*) (Lisp_Object));
  356. extern int point_in_line_start_cache (struct window *w, Bufpos point,
  357.                       int min_past);
  358. extern int point_would_be_visible (struct window *w, Bufpos startp,
  359.                    Bufpos point);
  360. extern Bufpos start_of_last_line (struct window *w, Bufpos startp);
  361. extern Bufpos end_of_last_line (struct window *w, Bufpos startp);
  362. extern Bufpos start_with_line_at_pixpos (struct window *w, Bufpos point,
  363.                      int pixpos);
  364. extern Bufpos start_with_point_on_display_line (struct window *w, Bufpos point,
  365.                         int line);
  366. extern redisplay_variable_changed (Lisp_Object sym, Lisp_Object *val,
  367.                    struct buffer *b, int flags);
  368.  
  369.  
  370. /* defined in redisplay-output.c */
  371. extern int get_next_display_block (layout_bounds bounds,
  372.                    display_block_dynarr *dba, int start_pos,
  373.                    int *next_start);
  374. extern void redisplay_clear_bottom_of_window (struct window *w,
  375.                           display_line_dynarr *ddla,
  376.                           int min_start, int max_end);
  377. extern void redisplay_update_line (struct window *w, int first_line,
  378.                    int last_line, int update_values);
  379. extern void redisplay_output_window (struct window *w);
  380. extern int redisplay_move_cursor (struct window *w, Bufpos new_point,
  381.                   int no_output_end);
  382. extern void redisplay_redraw_cursor (struct frame *f, int run_begin_end_meths);
  383. extern void output_display_line (struct window *w, display_line_dynarr *cdla,
  384.                  display_line_dynarr *ddla, int line,
  385.                  int force_start, int force_end);
  386.  
  387. /*
  388.  * Extern's for redisplay defined global variables.
  389.  */
  390.  
  391. /* #### organize this crap */
  392.  
  393. /* nil or a symbol naming the window system
  394.    under which emacs is running
  395.    ('x is the only current possibility) */
  396. extern Lisp_Object Vwindow_system;
  397.  
  398. /* Version number of X windows: 10, 11 or nil.  */
  399. extern Lisp_Object Vwindow_system_version;
  400.  
  401. /* Nonzero means truncate lines in all windows less wide than the frame */
  402. extern int truncate_partial_width_windows;
  403.  
  404. extern int in_display;
  405.  
  406. /* Nonzero means no need to redraw the entire frame on resuming
  407.    a suspended Emacs.  This is useful on terminals with multiple pages,
  408.    where one page is used for Emacs and another for all else. */
  409. extern int no_redraw_on_reenter;
  410.  
  411. /* Nonzero means flash the frame instead of ringing the bell.  */
  412. extern int visible_bell;
  413.  
  414. /* Thickness of shadow border around 3D modelines. */
  415. extern Lisp_Object Vmodeline_shadow_thickness;
  416.  
  417. /* Scroll if point lands on the bottom line and that line is partially
  418.    clipped. */
  419. extern int scroll_on_clipped_lines;
  420.  
  421. /* Quick flags to signal redisplay.  redisplay() sets them all to 0
  422.    when it finishes.  If none of them are set when it starts, it
  423.    assumes that nothing needs to be done.  Functions that make a change
  424.    that is (potentially) visible on the screen should set the
  425.    appropriate flag.
  426.  
  427.    If any of these flags are set, redisplay will look more carefully
  428.    to see if anything has really changed. */
  429.  
  430. /* non-nil if the contents of a buffer have changed since the last time
  431.    redisplay completed */
  432. extern int buffers_changed;
  433. extern int buffers_changed_set;
  434.  
  435. /* Nonzero if head_clip or tail_clip of a buffer has changed
  436.  since last redisplay that finished */
  437. extern int clip_changed;
  438. extern int clip_changed_set;
  439.  
  440. /* non-nil if any extent has changed since the last time redisplay completed */
  441. extern int extents_changed;
  442. extern int extents_changed_set;
  443.  
  444. /* non-nil if any face has changed since the last time redisplay completed */
  445. extern int faces_changed;
  446.  
  447. /* Nonzero means one or more frames have been marked as garbaged */
  448. extern int frame_changed;
  449.  
  450. /* True if a menubar is in need of updating somewhere. */
  451. extern int menubar_changed;
  452. extern int menubar_changed_set;
  453.  
  454. /* true iff we should redraw the modelines on the next redisplay */
  455. extern int modeline_changed;
  456. extern int modeline_changed_set;
  457.  
  458. /* non-nil if point has changed in some buffer since the last time
  459.    redisplay completed */
  460. extern int point_changed;
  461. extern int point_changed_set;
  462.  
  463. /* non-nil if some frame has changed its size */
  464. extern int size_changed;
  465.  
  466. /* non-nil if some device has signaled that it wants to change size */
  467. extern int asynch_device_change_pending;
  468.  
  469. /* non-nil if any toolbar has changed */
  470. extern int toolbar_changed;
  471. extern int toolbar_changed_set;
  472.  
  473. /* non-nil if any window has changed since the last time redisplay completed */
  474. extern int windows_changed;
  475.  
  476. /* non-nil if any frame's window structure has changed since the last
  477.    time redisplay completed */
  478. extern int windows_structure_changed;
  479.  
  480. /* These macros can be relatively expensive.  Since they are often
  481.    called numerous times between each call to redisplay, we keep track
  482.    if each has already been called and don't bother doing most of the
  483.    work if it is currently set. */
  484.  
  485. #define MARK_TYPE_CHANGED(object) do {                    \
  486.   if (!object##_changed_set) {                        \
  487.     Lisp_Object dev;                            \
  488.     DEVICE_LOOP (dev)                            \
  489.       {                                    \
  490.         Lisp_Object frm;                        \
  491.         struct device *d = XDEVICE (XCONS (dev)->car);            \
  492.         FRAME_LOOP (frm, d)                        \
  493.       XFRAME (XCONS (frm)->car)->object##_changed = 1;        \
  494.         d->object##_changed = 1;                    \
  495.       }                                    \
  496.     object##_changed = 1;                        \
  497.     object##_changed_set = 1; }                        \
  498.   }  while (0)
  499.  
  500. #define MARK_BUFFERS_CHANGED MARK_TYPE_CHANGED(buffers)
  501. #define MARK_CLIP_CHANGED MARK_TYPE_CHANGED(clip)
  502. #define MARK_EXTENTS_CHANGED MARK_TYPE_CHANGED(extents)
  503. #define MARK_MENUBAR_CHANGED MARK_TYPE_CHANGED(menubar)
  504. #define MARK_MODELINE_CHANGED MARK_TYPE_CHANGED(modeline)
  505. #define MARK_POINT_CHANGED MARK_TYPE_CHANGED(point)
  506. #define MARK_TOOLBAR_CHANGED MARK_TYPE_CHANGED(toolbar)
  507.  
  508. /* Anytime a device or frame is added or deleted we need to reset
  509.    these flags. */
  510. #define RESET_CHANGED_SET_FLAGS                        \
  511.   do {                                    \
  512.     buffers_changed_set = 0;                        \
  513.     clip_changed_set = 0;                        \
  514.     extents_changed_set = 0;                        \
  515.     menubar_changed_set = 0;                        \
  516.     modeline_changed_set = 0;                        \
  517.     point_changed_set = 0;                        \
  518.     toolbar_changed_set = 0;                        \
  519.   } while (0)
  520.  
  521. #endif /* _XEMACS_REDISPLAY_H_ */
  522.